home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / dev / lang / nrcobol_1b.lha / NRCOBOL1b / NRCOBOL.readme < prev    next >
Text File  |  1997-11-06  |  15KB  |  436 lines
  1. NRcobol Version 1.0b  by cHArRiOTt November 97
  2.  
  3.  
  4.  
  5.   1.Introduction
  6.   2.Installation
  7.   3.Usage
  8.   4.Syntax
  9.   5.Implemented?
  10.   6.History
  11.   7.Todo
  12.   8.Bugs
  13.   9.Feedback
  14.  10.Contacts
  15.  11.Distribution
  16.  12.Credits
  17.  13.Disclimer
  18.  
  19.  14.Apologies
  20.  15.Thanks
  21.  
  22.  
  23. NUff REsPEct.....peace n more time.
  24.  
  25. -------------------------------------------------------------------------
  26.    1.Introduction ...Why COBOL?
  27.  
  28.  
  29. To those of you thinking not another new language, COBOL is in fact one
  30. of the oldest high-level languages, its roots going back to the late
  31. 1950's. Ofcourse there are those of you who already know this but regard
  32. COBOL as not so much an high-level language, as the original computer
  33. virus. To these people i say RESPECT the source of the mother tounge. (sic!)
  34.  
  35. When so many languages have come and gone (what ever happended to
  36. Modulus II), COBOL has seen in the advent of STRUCTURED,and now OBJECT
  37. methodologies, its adapted absorbing the latest in Database Management, SQL
  38. etcetera, and gone on from strength to strength. Indeed as an introduction
  39. to records there's alot to be said in its favour. So when people say why,
  40. i say why not?
  41.  
  42.  
  43. This implementation of COBOL is largely ANSI 85 compatable and takes the
  44. form of MicroSoft(TM) COBOL, with maybe the exception of some stuff in
  45. ENVIRONMENT DIVISION - SPECIAL-NAMES. And some stuff left over from the days
  46. when memory was premium and no one had the imagination to contemplate speed.
  47. see Implementation?
  48.  
  49.  
  50. This would have been bought to you sooner, if it weren't for the moron, in
  51. the bedsit down stairs, with something of an habit!! which in lean times
  52. even extend to a fixation with gas. 'would you adam n eve it'.
  53.  
  54. WARNING dope really @&*$% you up! something to do with short term memory
  55. going to pot!
  56.  
  57.  
  58.  
  59. STOP THE PRESS!.
  60.  
  61. "COMPUTING" MAY 8th 97
  62.  
  63. 'Cobol crisis looms' The skills cris is luring Cobol programmers out of
  64. retirement with offers  of up to £1000 ($1700) per day......  hmm :-)
  65.  
  66.  
  67.  
  68. -------------------------------------------------------------------------
  69.    2.Installation
  70.  
  71.  
  72. Nothing could be simpiler, Just copy the runtime program 'RUNCOB' anywhere
  73. in your path, that's ram: c: or in the same directory as the created .INT
  74. files.
  75.  
  76. Files with the extension .INT are created as a result of successfully
  77. running NRCOBOL ..see Usage
  78.  
  79.  
  80. -------------------------------------------------------------------------
  81.    3.Usage
  82.  
  83.  
  84. After creating your cobol source file with your favourite text editor,
  85. and saving it with the .COB extention you have a choise of evoking the
  86. compiler from CLI/shell or Workbench.
  87.  
  88. From CLI/SHELL
  89.  
  90.      NRCOBOL <sourcefile>.COB [-l] [-d]
  91.  
  92. where the optional flags:
  93.  
  94.      -l   produces a simple listing  <sourcefile>.LST
  95.      -d   produces a debug  listing  <sourcefile>.DBG
  96.  
  97. A successfull compilation produces <sourcefile>.INT
  98. to run type...  RUNCOB <sourcefile>.INT
  99.  
  100.  
  101.  
  102.  
  103. From Workbench
  104.  
  105.      Use of the program from workbench is self explanatory, but for those
  106.      too dim.
  107.  
  108.  
  109.      +---------------------------------------------+
  110.      |                                        [.][#]
  111.      |+------------------------------------------+-|
  112.      ||Titles                                   || |    <-- What When Who
  113.      ||                                         || |
  114.      ||                                         || |
  115.      |+-----------------------------------------+| |
  116.      |File: |                                   || |    <-- current sourcefile.COB
  117.      |      +-----------------------------------+| |
  118.      |__________________________________________ | |
  119.      ||                                         || |
  120.      || IDENTIFICATION                 *        || |    <-- status block
  121.      || ENVIRONMENT                    *        || |         *'s replaced by
  122.      || DATA                           *        || |        PASSED or FAILED
  123.      || PROCEDURE                      *        || |
  124.      ||                                         || |
  125.      ||                                         || |    <-- current line
  126.      |+-----------------------------------------+| |
  127.      |+----------+      +---+       +--+ +------+| |    <-- ancillary output files
  128.      ||          | List +---+ Debug +--+ |      || |        as  .LST  and/or .DBG
  129.      || COMPILE  | +--------+ +--------+ |EDITOR|| |
  130.      ||          | |  LOAD  | |  EXIT  | |      ||_|
  131.      |+----------+ +--------+ +--------+ +------+|=|
  132.      +-------------------------------------------+-+
  133.  
  134.           ^            ^            ^        ^
  135.           |            |            |        |
  136.           |            |            |    Edit sourcefile.COB/LST/DBG
  137.           |       filerequester     |
  138.     Make it so #1              Exit  program or
  139.                                Abort compilation or
  140.                                RUN   succesful compilation (@{"whoops!" link "Implemented?" 0})
  141.  
  142.  
  143.    The Editor option allows one to view sourcefile.COB, sourcefile.LST or
  144.    sourcefile.DBG. The file editor defaults to 'ED' as supplied in sys:c.
  145.    You can however, set TEXTEDITOR in NRcobol's icon to launch your favourite
  146.    editor. eg  TEXTEDITOR=c:ced . Note no space between = and editor named.
  147.  
  148.  
  149.  
  150. In both cases an ICON is produced named <sourcefile>.INT
  151. to execute just double click.
  152.  
  153.  
  154. The debug option produces a file which you may find useful in locating
  155. runtime errors, which sadly is normal for cobol. Usually this is to do with
  156. uninitialised variables, you know, finding alpha data in a numeric field.
  157.  
  158. Runtime errors usually return a value in the form 0x????, where 0x???? is an
  159. offset into the data space allocated in the Data Division. Stradling values,
  160. ie value between offset values indicates a postion within a table,
  161. (a subsripted identifier).
  162.  
  163. -------------------------------------------------------------------------
  164.    4.Syntax
  165.  
  166.  
  167.    I may at a later date add the syntax, in the mean time the following
  168.    books are recomended:
  169.  
  170.  
  171.    -  COBOL for the IBM Personal Computer by kip R Irvine
  172.  
  173.    -  COBOL for the 80's                  by J Wayne Spence
  174.  
  175.    -  Structured  Programming in COBOL    by B J Holmes
  176.  
  177.    -  COBOL 85 for programmers            by Jim Inglis
  178.  
  179.  
  180.    OK go on then..
  181.  
  182. -------------------------------------------------------------------------
  183.    OK go on then..  The basics.
  184.  
  185.  
  186.    In Every Dam Program there are four division.
  187.  
  188.       INTRODUCTION DIVISION.
  189.       PROGRAM-ID.  <>.
  190.  
  191.       ENVIRONMEMT  DIVISION.
  192.  
  193.  
  194.       DATA         DIVISION.
  195.  
  196.  
  197.       PROGRAM      DIVISION.
  198.  
  199.  
  200.            ACCEPT           ADD           CALL           CANCEL
  201.            CLOSE            COMPUTE       CONTINUE       DELETE
  202.            DISPLAY          DIVIDE        EVALUATE       EXIT
  203.            GO               IF            INITIALIZE     INSPECT
  204.            MERGE            MOVE          MULTIPLY       OPEN
  205.            PERFORM          READ          RELEASE        RETURN
  206.            REWRITE          SEARCH        SET            SORT
  207.            START            STOP          STRING         SUBTRACT
  208.            UNSTRING         USE           WRITE
  209.  
  210.  
  211. -------------------------------------------------------------------------
  212.    5.Implemented?
  213.  
  214.  
  215.    IDENTIFICATION DIVISION.
  216.  
  217.    The program-id is required to be the same as the filename bar the
  218.    .COB file extention. This allows for consistent CALLs to subprogram
  219.    and nested programs ie via their program-ids.
  220.  
  221.  
  222.    ENVIRONMEMT  DIVISION.
  223.  
  224.  
  225.    The only options supported in SPECIAL-NAMES are CURRENCY and DECIMAL-POINT.
  226.    I-O-CONTROL SECTION. recodnised but not implemented!
  227.  
  228.    DATA         DIVISION.
  229.  
  230.    There is no support for the REPORT SECTION or communications.
  231.    BLOCK and RECORD clauses recodnised but not implemented!
  232.    USAGE IS default always ie no support yet for PACKED / BINARY etc..
  233.    SYNCHRONISED is recodnised but not implemented!
  234.    SCREEN SECTION is as defined by Microsoft 2.XX , i may add some supports
  235.    for basic BUTTON GADGETS later!
  236.  
  237.    PROGRAM      DIVISION.
  238.  
  239.    All keywords above have been implemented!
  240.  
  241.    CORR/CORRESPONDING not supported.
  242.    reference modification pending!
  243.  
  244. -------------------------------------------------------------------------
  245.    6.History
  246.  
  247.  
  248.  
  249.   1.00  July     97  -  first release CU Amiga Magazine
  250.   1.0a  August   97  -  CU Amiga Magazine / Aminet
  251.                         resort to pre 'reference moddification' version, since
  252.                         last minute addition of reference modification option
  253.                         introduced strange/terminal errors ...sorry!
  254.   1.0b  November 97  -  font sensitive main program
  255.                         NRCOBOL compiled under GNU C 270 ,just!
  256.                         still trying with runcob  (NorthC1.3 + A68k)
  257.                         support only for A1200 or better
  258.                         ...unless i get feedback from pre A1200 users :)
  259.                         MOVE ALL ...
  260.                         HIGH-VALUE(S)  LOW-VALUE(S)  sign sensitive
  261.                         blank when zero should now work
  262.                         fixed oversight with full stop now allowed in zone/margine A
  263.  
  264.                         relaxed LEVEL 02-49 positioning, now allowed in zone/margine A
  265.  
  266. -------------------------------------------------------------------------
  267.    7.Todo
  268.  
  269.  
  270.    -   font sensitive main program
  271.    -   font sensitive runtime screen
  272.    -   own rather than system input
  273.    -   Totally ANSI 85 see Implemented?
  274.    -   Intrinsic functions ANSI 89
  275.    -   support for SQL trainer module
  276.    -   OBJECT?????  Hmmmm :-)
  277.  
  278.  
  279. -------------------------------------------------------------------------
  280.    8.Bugs
  281.  
  282.    -
  283.  
  284. -------------------------------------------------------------------------
  285.    9.Feedback
  286.  
  287.  
  288.    -   'things aint wot they ougt a'
  289.    -   unexpected output or syntax ... well you never know
  290.    -   congratulations
  291.    -   bribes not to continue
  292.    -   buy outs / takeovers
  293.    -   Donations of money / hardware ;-)
  294.    -   or even a post card from what ever part of the planet you and your
  295.        Amiga reside. Amiga dead? Long live Amiga.
  296.    -   OBJECT COBOL example code???
  297.    -   Spare copy of latest ANSI COBOL standard??
  298.        this comes via limited access to Ansi74 plus the stuff at the back
  299.        of most books on COBOL
  300.    -   Offers of work :-(
  301.  
  302.  
  303.    email : HARRIOTTC@cardiff.ac.uk    (new!)
  304.    email : HA.ROT@bigfoot.com         (re-router/lifetime email curtesy of
  305.                                        http://WWW.bigfoot.com/)
  306.  
  307.    snail mail
  308.  
  309.            C Harriott
  310.            14a Splott Road
  311.            Splott
  312.            Cardiff
  313.            Cf2 2BZ
  314.            UK
  315. -------------------------------------------------------------------------
  316.    10.Contacts
  317.  
  318.    For further information on the COBOL scene you might try the FAQ
  319.    created and maintained by
  320.  
  321.       jfid@mfltd.co.uk (James Fidell)
  322.       http://www.mfltd.co.uk/~jfid/
  323.  
  324.  
  325. -------------------------------------------------------------------------
  326.    11.Distribution
  327.  
  328.  
  329.    Distribution is granted to anyone via floppy and internet/ BBS provided
  330.    documentation remains as is, only a nominal fee is charged for copying
  331.    and no attempt is made to reverse engineer the program.
  332.    Distribution is also granted to anyone compiling a CDROM provided the
  333.    above conditions are met AND i am sent a copy of the CDROM. Please??
  334.  
  335. -------------------------------------------------------------------------
  336.    12.Credits
  337.  
  338.    Would you belive i wrote this with the public domain 'C' compiler
  339.    NorthC 1.3 ...if you're out there S Hawtin thanks dude. Although i have to
  340.    say it makes for lazy programing. Hopefully GNU C will induce disipline!
  341.    Ouch!
  342.  
  343.  
  344.    Thanks expressed to Thore Böckelmann for the use of his disclimer (quite
  345.    frankley i couldn't have put it better myself) also thanks for gifting
  346.    the Amiga community his EXCELENT CyberAVI and CyberQT. A real babe of a
  347.    program. SHwing?? Now how about some avi/mov files AF/CUCD/ANOther?
  348.  
  349.  
  350.    Thanks to Markus Hillenbrand for that excellent GUI program GUICreator,
  351.    which was used to create (after much tweeking) the newface of NRCOBOL.
  352.    Please note the difference in compilation speeds is due solely to the use 
  353.    of gadtools.
  354.  
  355.  
  356.    Thanks also to those unknown warriors who gave their all to bring us the
  357.    freedom to program in assembler.. the authors of A68K and BLINK
  358.    without which.....  RESPECT!
  359.  
  360. -------------------------------------------------------------------------
  361.    13.Disclimer
  362.  
  363.  
  364. No warranty, either express or implied, is made with respect to the fitness  or
  365. merchantability of NRCOBOL.
  366.  
  367. cHArRiOTt (referred to as "the  author"),  reserves  the  right  to  not
  368. develop any future versions of NRCOBOL.
  369.  
  370. The author will try to make a good faith attempt at correcting any problems  if
  371. any are discovered, but is in no way required, nor bound to correct them.
  372.  
  373. The author neither assumes nor accepts any responsibility for the use or misuse
  374. of  these  programs.  He  will  also  not  be  held  liable  for damages or any
  375. compensation due to loss of profit or any other damages arising out of the use,
  376. or inability to use this program.
  377.  
  378. The author will not be liable for any damage arising from the failure  of  this
  379. program  to  perform as described, or any destruction of other programs or data
  380. residing on a system attempting to run the programs.
  381.  
  382. The user of this program uses it at his or her own risk.
  383.  
  384. -------------------------------------------------------------------------
  385.  14.Apologies
  386.  
  387.  
  388.     My apologies to anyone who tried and failed to make contact at my old email
  389.     address. At around  18th september my account was suddenly and without warning
  390.     terminated. Imagine my suprise to find i no longer exist, to find my account fini,
  391.     to find this parrot's dead. No longer on this mortal coil, no longer
  392.     with us, gone to software heaven, frankly needing more than a magnetic medium
  393.     to get in touch with our dearly departed data :((  KO'ed at HQ by HO.
  394.  
  395.     This ment not only the loss of pending email, but records on
  396.     all contacts made to date. If that wasn't bad enough, i had just, that week,
  397.     been published on the CDROM of the CU Amiga magazine (CUCD15), which ment all
  398.     those potential contacts are now lost.
  399.  
  400.     Anyway, due to an act of devine intervention, i am now back on line. Existing
  401.     from day to day, suddenly aware of my own mortality, unsure of the integrity
  402.     of the system, but gradualy rekindling my trust... bare with me. Willing to
  403.     forgive but never forget!
  404.  
  405.     If you were one of those who tried and failed, ...do call again y'all :*)
  406.  
  407. -------------------------------------------------------------------------
  408.  15.Thanks
  409.  
  410.  
  411.     Special thanks to the following who had made contact, and are fondly remembered:
  412.  
  413.  
  414.     Groetjes, JAVE.    ...pointing out fullstop zone error resulting in
  415.                           bad compilation of paragraph/section names less then 4 characters
  416.                           request for relaxation of level 02-49 zone 'B' done!
  417.  
  418.                        ...microFocus  COBOL85 info? still treading water?)
  419.  
  420.  
  421.     Charles Elliott    ...still beta testing? trace environment directives?
  422.  
  423.  
  424.     Claus Luethje      ...offer of docs, nice to know my prog, from its humble origins
  425.                           has found such a grand home. Wow the stuff dreams are made of !))
  426.  
  427.  
  428.  
  429.     i am afraid the rest of you went down with the great crash :((
  430.     ....do call again!    Peace n more time!
  431.  
  432. -------------------------------------------------------------------------
  433.  
  434.   'yep, it's so much more...jealous?'
  435.  
  436.